Belgian Amiga Club - ADF Collection/BS1 part 19.zip/BS1 part 19/Misc I util.adf/DiskX.doc

Text File | 1988-10-31 | 11KB | 288 lines

----------------
DiskX V2.2
By STEVE TIBBETT
----------------

This manual is created chronologically.  When I add new features, I tack
the description onto the end.  If you have used DiskX before, skip ahead to
the notes on whatever version is new to you.

This special edition of DiskX adds a "bootsave" feature that will let
you store boot blocks of protected commercial software, to protect them
should a virus attack the original.


INTRODUCTION:

DiskX's main purpose in life is to be a sector-based disk editor, as
opposed to a file-based editor such as NewZap.    DiskX can also be used
as a file editor.  That will be discussed a bit later on.

DiskX lets you view the disk in a block-by-block format.  It also lets
you find strings of text anywhere on the disk, find the first block of any
file, to view each block either as the mass of hex numbers it really is, and
to view the block as what it represents to AmigaDOS (i.e., file header
block, user directory block and such.  The different block types there can be
found in the AmigaDOS Manual by Bantam Books.

Important Note: When you run DiskX, it will leave the motor running on
whatever floppy drive you are currently examining.  Don't worry about it.


WHAT IS A DOS DEVICE?

DiskX lets you look at anything that AmigaDOS sees as a device.  If you
have a hard disk, there should be a hddisk.device, jdisk.device, or
something similar in the DEVS: directory on your Workbench disk.  This also
goes for the VD0: recoverable ram disk, which has asdg.vdisk.device there.

Note that the RAM: disk is not really a DOS device.  It is managed by
the RAM-HANDLER in the L directory, making it ineligible.

Also, DiskX will not allow you to look at the PAR:, PRT:, SER:, NIL:,
or anything else that isn't a device, because printers and modems don't like
being asked to return a specific cylinder.


RUNNING IT

When you first run DiskX, there is a menu on the menu bar called "Unit",
and on this menu will be all the "Devices" the system recognizes at the
time.  It will also show you the name of the "Driver" that controls that
device - "trackdisk.device" for a floppy and the like.

Workbench 1.3 includes a recoverable RAM: disk called "RAD:".  To DiskX,
this is just another device.


MODES OF OPERATION

DiskX has two modes of operaiton: HEX mode and INTERPRET mode.


HEX MODE

Hex Mode will allow you to look at what is actually in the block, 256
bytes at a time.  If you are looking at the first half of the block, the
offset will be less than 100 (in hex).  The offset is displayed at the
bottom right of the screen and reflects the current cursor position.

The cursor can be moved around either with the mouse point and click or
with the cursor keys.

While in hex mode, pressing the Return key will let you to enter ASCII
text, starting at the current cursor position.    Move the cursor to where you
want to start, press Return, type your text, then press Return again.  Note
that the cursor keys will not work when you are entering text, but the mouse
pointer will still allow you to move the cursor.

When in Hex Mode, there are a couple of extra gadgets (the square,
obnoxious-looking things) that pop up on the bottom of the screen.  There are
the "Other Half" gadget, which will show you the other half of the block;
the modify gadget, which will let you edit contents of that byte in either
hex, decimal, or binary; and the show type gadget, which will flip you into
interpret mode.

If you are running DiskX from the CLI, you can enter a commandline
argument "INTERLACE," which will cause DiskX to run in Interlaced mode,
showing you all 512 bytes of a block on one screen.


INTERPRET MODE

This is where the excitement lies!

In Interpret mode, instead of just showing you what is in the block as
hex, it tries to make some sense out of the block the same way AmigaDOS
does, showing only the contents of the block that are relevant to that block
type.  For example, if the block is a data block, you will see the contents
of actual DATA part of the block in the middle of the screen, and at the top
of the screen you will see where that block's file header block is located,
its sequence number, location of the next block and size of that next block.

When you're in Interpret mode, a few other keys come into play, also
depending on what type of block you are examining.  The left and right cursor
keys will move up/down by one block.

R will move you to that disk's root block.  P will bring you to that
block's parent block, if it has one.  N will bring you to the next block, if
the current block type supports it.  W will tell it to write the block back
to the disk, and E does won't do a darn thing.

Also, if the block type supports it, you will get either a "First Block",
"Next Block", or a "Parent Block" gadget on the screen.


FIND

Find will let you search for a string of text.    Type the string, then
select either to start from Here (the current Block Number), or Block #0.


KEY NUMBER VERSUS BLOCK NUMBER

The terms "key" and "block" get used fairly often here - they both mean
the same thing.  They refer to the current block number, which is how far
into the disk we are in 512 byte blocks.


PARENT BLOCK AND HEADER BLOCK

These two terms end up being used a good bit in the program.  Again, they
both mean the same thing: that this block is pointed to.


GETTING OUT

All good things must come to an end, and you've got three ways to end
it all from here: press the ESC key, click on the quit gadget, or use the
quit menu option.  And you're out.


NOTES

     -- DiskX will only work properly on devices which use a 512 byte block.
I have yet to see one that uses a different size block, so it didn't seem
like a big problem.

     -- If you want to change anything on your KickStart disk, there is a
public domain program called SumKick, which will fix the checksum on the KS
disk for you after you've changed it. Otherwise, whenever you Reboot, it
will want back Kickstart.


USES

Here are some uses:

     -- If you live in Canada, (like all the real people in the world, eh?
Turn the heat up, Bob.), you can take any program which refers to "State"
and change it to refer to "Prov." using the Find command.

     -- You can find hidden messages in your Kickstart disk.

     -- You can dig through your favorite game to find all kinds of strings
which may be helpful.

     -- You can waste a lot of time going through programs which hide any
ASCII text contained in them.

     -- Using the Write Block to File option, you could take any
auto-booting disk (the kind that uses the boot sector to load the game),
write it to a file, and disassemble it or whatever.


NEW FEATURES

The following are features that were new with the 2.0 release:

     -- Works with any DOS device, include hard disks.

     -- Ability to search the disk for ASCII strings without being
case-sensitive.

     -- Ability to recover a deleted file from any device.

     -- Ability to view all ASCII strings on the disk in a simple manner.


USING OTHER DOS DEVICES

DiskX will now read the DeviceList and find any device you are using in
the system, if it is a block-based device.  If your favorite device isn't on
the "Unit" menu, here's how to get it:  bring up the "Find File" requester
from the Project menu, and type the device name into the drawer area. That
should do it - if you go for "Disk Info" on the same menu, you will see
info on it.


CASE-INDEPENDENT SEARCH

When you search (using the Find... gadget on the main screen), if the
first character of the pattern you are searching for is an asterisk ( * ).
it will ignore the case of the string it is seeking.  If you tell it to
search for *Hello, it would find Hello, hELLO, HeLlO and other variations.

If the first character of the pattern you enter to seek is an "@"
(at sign), DiskX will treat this as though you were looking for a file name.
It will ignore case and will only stop at blocks which are file headers
whose file name matches this pattern.  More on this later.


SEARCHING FOR TEXT STRINGS

You can now search the whole disk, starting at either block zero, or
from the current position, for any ASCII text.    It will display any text
string longer than six characters.  It's a menu option.  Also, if you select
the "Through Links" option, you can start searching from a file header
(using the "Find File Header" menu option to find the file header) to search
through a particular file for text.  Also, take a look through the Kickstart
disk. There is much interesting material there.


RECOVERING FILES

You've just deleted a file.  The file's name is LostFile, and it is on
DH0:. Here's how to get it back:

1.  Select the DH0: menu option on the Project menu in the Unit Number
    submenu.  Same thing applies for any device.

2.  Click on the Find... gadget on the bottom of the main screen.  Tell
    it to search for "@LostFile".  This will find LostFile's file header
    block and make it the current block.  Remember that the @ sign tells
    DiskX you're looking for a file header.  You will probably have to try
    the "Show Type" gadget to get it to tell you that it is a file header.
    Note that doing a Find on a hard disk can take a good bit of time.

3.  Select the "Recover..." menu option. DiskX will then search the entire
    disk for any block whose parent block field points to the file header
    for LostFile.  That's block belonging to Lostfile.

4.  When the search is completed there will be a file requester asking
    you where you want the file to be written.    DO NOT WRITE THE FILE TO
    THE SAME DEVICE FROM WHICH YOU ARE RECOVERING IT.  While the chances
    are you won't have any major problems doing it, things could go wrong.
    A safe place to write to is the RAM: disk, and it's the default drive
    when this requester appears.

5.  After you've entered the new name for the file here, choose OK or press
    Return, and the file will be recovered.  That's it.


NEW FEATURES TO 2.1

Bug Fixes: No longer writes back to wrong HD partition


NEW TO 2.2

The "bootsave": feature.


RECOVERING FILES THE HARD WAY

On the special menu, there is an option to write the current block to a
file.  The first time you select this option, you will be asked for the file
name into which you want to write the data.  Each time you go for this option
after that, it will write the block into the same file, if you haven't
closed it already.

If you plan to write a number of blocks during the same session, don't
close the file after each write.  Wait until you have written all you want
and then close the file.

If the block you are writing is a data block (part of a file), only the
data part of the block (488 bytes) will be written; otherwise, all 512
bytes, including the block's checksum, will be written.

If you forget to close the file on quitting, DiskX closes it for you.

If when you first select the drive, the block you see is not of type
root block, you will have to go up or down a cylinder or two to find it.
It's just a minor task.  Also, the "Disk Info" menu option will show the
disk's name wrong.

END OF TEXT